home *** CD-ROM | disk | FTP | other *** search
/ Aminet 2 / Aminet AMIGA CDROM (1994)(Walnut Creek)[Feb 1994][W.O. 44790-1].iso / Aminet / util / gnu / diff_2_3.lha / diff-2.3 / README.Amiga < prev    next >
Text File  |  1993-05-26  |  5KB  |  123 lines
  1.               GNU Diff, Diff3, SDiff and Cmp Version 2.3
  2.               ------------------------------------------
  3.  
  4.                      Amiga Port by Carsten Steger
  5.                      ----------------------------
  6.  
  7. Hi everyone!
  8.  
  9. In this directory you  will find the complete source code of GNU Diff.
  10. All the modifications  I had to make to get it to compile and run with
  11. SAS/C 6.2  are bracketed by  '#ifdef AMIGA' constructions. I also have
  12. included a  diff  file  (generated by diff 2.3,  of  course :-) ) that
  13. contains the context diffs to the original distribution.
  14.  
  15. Diff  should run under any OS  version with  one exception: If you use
  16. the '-l' resp.  '--paginate'  flag you have to have OS 2.0  or higher.
  17. This is due to the fact that I had to use the 'System' call to run pr.
  18. For  those of you that don't have  pr: it is obtainable by ftp at  any
  19. Aminet  site that  carries  all  uploaded  files (e.g.   ftp.luth.se).
  20. Download the  file amiga-textutils-1.3.lha that comes with David Gay's
  21. brilliant  port of  GNU  Emacs. If you don't have ftp  access, but are
  22. able to send and receive  e-mail,  you can try one of the various  ftp
  23. mail-servers (e.g.  BITFTP@pucc.princeton.edu;  send  a  mail  message
  24. saying 'help' to that address for instructions).
  25.  
  26. There  are a couple  of  minor  differences  to  diff  under UN*X: The
  27. current  directory  is referred  to by  "".  So  if you want to diff a
  28. directory <dir> against  the current directory, type 'diff  <dir> ""'.
  29. If you want to change the line- and line-group-format, here's how it's
  30. done on the Amiga  (see also the sections  'Line Formats', 'Line Group
  31. Formats', and 'Detailed If-then-else' in the manual):
  32.  
  33. On UN*X you would type:
  34.  
  35. diff \
  36.    --old-line-format='-%l
  37. ' \
  38.    --new-line-format='|%l
  39. ' \
  40.    --unchanged-line-format=' %l
  41. ' \
  42.    old new
  43.  
  44. On the Amiga you have to type this as (type <RETURN> after each '+'):
  45.  
  46. diff "--old-line-format=-%l+
  47. " "--new-line-format=|%l+
  48. " "--unchanged-line-format= %l+
  49. " old new
  50.  
  51. Summing up: if you want to insert a newline into an argument, type '+'
  52. followed by <RETURN>.  This seems to be the only  way to do this  with
  53. the Commodore shell.
  54.  
  55. NB: The files in the '-x' resp. '--exclude'  option are specified with
  56. UN*X wildcards (as stated in the maunual): Use  '*.o'  to  get '#?.o'!
  57. (This is because the exclusion is done internally using the GNU regexp
  58. library.)
  59.  
  60. Diff3 only runs under OS  2.0  or higher. This is because I had to use
  61. the 'System' call to run the two child processes that diff3 spawns.
  62.  
  63. Sdiff, too, only runs under  OS  2.0 or  higher for the same reason as
  64. above. Please note that if you break the program with C-c or by typing
  65. the  'q' command within  sdiff, it  might take some time to  clear the
  66. pending pipe in- and output.  Otherwise the program should run exactly
  67. as described in the maual.   The  default editor  that  sdiff uses  is
  68. MEmacs  from the good old Workbench.   You should have it somewhere in
  69. your path.  Otherwise you have to set the EDITOR environment variable:
  70. setenv EDITOR <your favourite editor>.
  71.  
  72. Cmp runs under any OS version.
  73.  
  74. To install the  programs  you  just copy them  to a  directory in your
  75. path:
  76.  
  77. copy c/#? <directory>
  78.  
  79. The documentation is included in the diff.texi file. Since the release
  80. of version 2.2 I don't provide a TeX'ed  version of  the documentation
  81. anymore  (mainly to save disk-space).  If you want to  get the printed
  82. documentation  I suggest that you  get the makeinfo package  mentioned
  83. below. This  package contains an Amiga-version of texindex.  For those
  84. of you  that don't have TeX: An excellent port of TeX for the Amiga by
  85. Georg Hessman (PasTeX)  is obtainable by ftp at ftp.uni-passau.de.  If
  86. you have all  these  programs  available, take  the following steps to
  87. produce the file diff.dvi that can be printed with the appropriate TeX
  88. printer driver (if  you have a shell that does  wildcard expansion for
  89. you the 'spat' command is not necessary):
  90.  
  91. tex diff.texi
  92. spat texindex diff.??
  93. tex diff.texi
  94. spat texindex diff.??
  95. tex diff.texi
  96.  
  97. If you  have the infamous  Am*gaGuide, I highly recommend that you use
  98. makeinfo by Sebastiano Vigna and Reinhard Spisser (on Fish disk 787 or
  99. by  ftp at  any  aminet  site  that  carries  all files)  and  convert
  100. diff.texi into the Am*gaGuide format for online documentation.
  101.  
  102. If you use GNU  Emacs  on the  Amiga  you  might want to  install  the
  103. #?.info#?   files in  GNUEMACS:info  too.   You will  have to make  an
  104. appropriate entry in the dir file in this case.
  105.  
  106. If you  have  any  problems that you think are  specific to the  Amiga
  107. version of diff, e.g. you get a different result on the Amiga than the
  108. result you get on a  UN*X machine,  you should report them to  me.  My
  109. E-mail address is:
  110.  
  111. carsten.steger@informatik.tu-muenchen.de
  112.  
  113. If you think you have found any  other bugs, you should report them to
  114. the GNU project. Their address is:
  115.  
  116. bug-gnu-utils@prep.ai.mit.edu
  117.  
  118.  
  119.  
  120. Have fun!
  121.  
  122. Carsten
  123.